Saltar al contenido principal

Detalle de Compliance

Este endpoint entrega el reporte completo de Compliance de un RUT cargado en tu cuenta, sea de una persona natural o jurídica: sociedades relacionadas, listas internacionales, antecedentes penales, noticias, Personas Expuestas Políticamente (PEP), familiares de PEP y funcionarios públicos. Si el RUT tiene análisis Marshal, el reporte incluye también sus hallazgos.

  • Consultar un RUT ya cargado en tu cuenta no genera costos adicionales.
  • El RUT debe estar cargado en tu cuenta antes de la consulta (ver Carga de RUT).
  • Requiere que tu plan incluya el ayudante Compliance.
  • Las coincidencias se buscan en las fuentes al momento de la consulta.
  • La respuesta depende de si el RUT corresponde a una persona jurídica o a una persona natural.
Qué cambia respecto a la v2
  • Se agrega marshal.detectado en pepChile y familiaresPep, y los hallazgos de Marshal aparecen en noticias.
  • periodo se entrega en formato DD-MM-YYYY cuando es una fecha exacta, y en null cuando la fuente no lo informa.
  • tipoPersona usa "juridica" en lugar de "juridical".

Ver la Guía de Migración.

Detalle de API​

Request​

  • URL: /helper/compliance/{rut}
  • Método: GET

Parámetros de ruta (path)​

ValorTipoEs requeridoDescripción
rutstringSíRUT a consultar, en formato 12345678-9.

Ejemplo request con curl​

curl -X 'GET' \
'https://prod.api.thesheriff.cl/api/clients/v3/helper/compliance/76123456-0' \
-H 'accept: application/json' \
-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9EjemploDeToken123'

Response​

CampoTipoDescripción
successboolIndica si la operación fue exitosa.
dataobjectReporte completo de Compliance del RUT consultado.

Diferencias por tipo de persona​

El campo tipoPersona indica si el RUT corresponde a una persona jurídica ("juridica") o a una persona natural ("natural"). Ambos tipos devuelven las mismas keys, pero con distinto contenido:

CampoPersona jurídicaPersona natural
tipoPersona"juridica""natural"
nombreRazón socialNombre completo de la persona
sociedades.coincidenciasUna fila: la sociedad consultada, con nombreSocio, rutSocio y fuente en nullUna fila por cada sociedad en la que participa la persona, con sus datos en nombreSocio y rutSocio
pepChile, familiaresPep, funcionariosPublicosSin coincidencias: las búsquedas de PEP, familiares de PEP y funcionarios públicos no se hacen para personas jurídicas. marshal.detectado se informa igualCoincidencias encontradas

Respuesta para persona jurídica​

Success

  • Status code: 200

  • Example response body:

    {
    "success": true,
    "data": {
    "rut": "76123456-0",
    "estado": "PROCESADO",
    "tipoPersona": "juridica",
    "nombre": "EMPRESA FICTICIA SPA",
    "riesgo": "critical",
    "sociedades": {
    "coincidencias": [
    {
    "nombreSociedad": "EMPRESA FICTICIA SPA",
    "rutSociedad": "76123456-0",
    "nombreSocio": null,
    "rutSocio": null,
    "fecha": "2021-06-02",
    "socios": [
    {
    "nombre": "SOCIO FICTICIO UNO",
    "rut": "11111111-1",
    "domicilio": "CALLE EJEMPLO 123, LAS CONDES",
    "tipoDeParticipacion": "Administrador - Socio",
    "cargo": null,
    "porcentajeParticipacion": "70"
    }
    ],
    "extractos": [
    {
    "actuacion": "CONSTITUCION",
    "fecha": "2021-06-02",
    "url": "https://www.diariooficial.interior.gob.cl/publicaciones/2021/06/02/"
    }
    ],
    "participaciones": [
    {
    "razonSocial": "FILIAL FICTICIA SPA",
    "nombre": "FILIAL FICTICIA SPA",
    "rut": "33333333-3",
    "tipoPersona": "juridica",
    "tipoDeParticipacion": "SOCIO",
    "cargo": null,
    "porcentajeParticipacion": "50",
    "domicilio": null,
    "vigente": true
    }
    ],
    "fuente": null
    }
    ],
    "totalCoincidencias": 1
    },
    "listasInternacionales": {
    "coincidencias": [
    {
    "nombre": "EMPRESA FICTICIA SPA",
    "lista": "OFAC - Office of Foreign Assets Control",
    "url": "https://sanctionssearch.ofac.treas.gov/"
    }
    ],
    "totalCoincidencias": 1
    },
    "penal": {
    "coincidencias": [],
    "totalCoincidencias": 0
    },
    "noticias": {
    "coincidencias": [
    {
    "nombre": "EMPRESA FICTICIA SPA",
    "titulo": "Formalizan a gerente de Empresa Ficticia SpA",
    "fuente": "df.cl",
    "url": "https://www.df.cl/noticia-ficticia",
    "urlFuente": "https://df.cl",
    "tema": ["Riesgo Financiero"],
    "periodo": "14-08-2026"
    },
    {
    "nombre": "EMPRESA FICTICIA SPA",
    "titulo": "Multa de la CMF a Empresa Ficticia",
    "fuente": "La Tercera",
    "url": "https://www.latercera.com/noticia-ficticia",
    "urlFuente": "https://www.latercera.com",
    "tema": ["multas"],
    "periodo": "16-01-2025"
    }
    ],
    "totalCoincidencias": 2
    },
    "pepChile": {
    "coincidencias": [],
    "totalCoincidencias": 0,
    "marshal": {
    "detectado": false
    }
    },
    "familiaresPep": {
    "coincidencias": [],
    "totalCoincidencias": 0,
    "marshal": {
    "detectado": false
    }
    },
    "funcionariosPublicos": {
    "coincidencias": [],
    "totalCoincidencias": 0
    }
    }
    }

Campos dentro de data (persona jurídica):

CampoTipoPuede ser nullDescripción
rutstringNoRUT consultado (formato 12345678-9).
estadostringNo"PROCESADO" o "NO PROCESADO" (ver Sin búsqueda posible).
tipoPersonastringNoSiempre "juridica".
nombrestringNoRazón social usada en la búsqueda; "" si no hay.
riesgostringNoRiesgo agregado del perfil: "free", "medium" o "critical".
sociedadesobjectNoLa sociedad consultada (ver tabla siguiente).
listasInternacionalesobjectNoCoincidencias en listas internacionales y total.
penalobjectNoCoincidencias de antecedentes penales y total.
noticiasobjectNoCoincidencias de noticias, incluidos los hallazgos de Marshal, y total.
pepChileobjectNocoincidencias: [] y totalCoincidencias: 0: la búsqueda de PEP no se hace para personas jurídicas. marshal.detectado puede ser true si Marshal detectó un PEP (ver Marshal).
familiaresPepobjectNocoincidencias: [] y totalCoincidencias: 0: la búsqueda de familiares de PEP no se hace para personas jurídicas. marshal.detectado puede ser true si Marshal detectó una relación con un PEP.
funcionariosPublicosobjectNocoincidencias: [] y totalCoincidencias: 0: la búsqueda de funcionarios públicos no se hace para personas jurídicas.

sociedades.coincidencias[] (persona jurídica): un único elemento con la sociedad consultada.

CampoTipoPuede ser nullDescripción
nombreSociedadstringSíRazón social de la sociedad consultada.
rutSociedadstringSíRUT de la sociedad consultada.
nombreSociostringSiempreNo aplica a personas jurídicas.
rutSociostringSiempreNo aplica a personas jurídicas.
fechastringSíFecha de constitución de la sociedad (formato YYYY-MM-DD).
sociosarrayNoSocios de la sociedad (ver Estructuras comunes).
extractosarrayNoExtractos o publicaciones de la sociedad.
participacionesarraySíSociedades en las que la sociedad consultada participa.
fuentestringSiempreNo aplica: la sociedad consultada no llega por una relación.

Respuesta para persona natural​

Success

  • Status code: 200

  • Example response body:

    {
    "success": true,
    "data": {
    "rut": "11111111-1",
    "estado": "PROCESADO",
    "tipoPersona": "natural",
    "nombre": "JUAN PEREZ SOTO",
    "riesgo": "critical",
    "sociedades": {
    "coincidencias": [
    {
    "nombreSociedad": "EMPRESA FICTICIA SPA",
    "rutSociedad": "76123456-0",
    "nombreSocio": "JUAN PEREZ SOTO",
    "rutSocio": "11111111-1",
    "fecha": "2021-06-02",
    "socios": [
    {
    "nombre": "JUAN PEREZ SOTO",
    "rut": "11111111-1",
    "domicilio": "CALLE EJEMPLO 123, LAS CONDES",
    "tipoDeParticipacion": "Administrador - Socio",
    "cargo": null,
    "porcentajeParticipacion": "70"
    }
    ],
    "extractos": [
    {
    "actuacion": "CONSTITUCION",
    "fecha": "2021-06-02",
    "url": "https://www.diariooficial.interior.gob.cl/publicaciones/2021/06/02/"
    }
    ],
    "participaciones": [],
    "fuente": "Empresa en un Día"
    },
    {
    "nombreSociedad": "INVERSIONES FICTICIAS LIMITADA",
    "rutSociedad": "77777777-7",
    "nombreSocio": "JUAN PEREZ SOTO",
    "rutSocio": "11111111-1",
    "fecha": "2015-03-10",
    "socios": [
    {
    "nombre": "JUAN PEREZ SOTO",
    "rut": "11111111-1",
    "domicilio": null,
    "tipoDeParticipacion": "Socio",
    "cargo": null,
    "porcentajeParticipacion": "40"
    }
    ],
    "extractos": [],
    "participaciones": [],
    "fuente": "Diario Oficial"
    }
    ],
    "totalCoincidencias": 2
    },
    "listasInternacionales": {
    "coincidencias": [],
    "totalCoincidencias": 0
    },
    "penal": {
    "coincidencias": [
    {
    "nombre": "JUAN PEREZ SOTO",
    "postura": "Querellado",
    "rol": "O-1234-2020",
    "fecha": "23/11/2024",
    "infraccion": "ESTAFA",
    "estado": "Tramitación",
    "etapa": "Investigación",
    "litigantes": [
    {
    "nombre": "JUAN PEREZ SOTO",
    "sujeto": "Querellado",
    "situacionLibertad": "Libre"
    }
    ],
    "materia": "Querella",
    "tribunal": "JUZGADO DE GARANTÍA FICTICIO",
    "esDenunciado": true
    }
    ],
    "totalCoincidencias": 1
    },
    "noticias": {
    "coincidencias": [],
    "totalCoincidencias": 0
    },
    "pepChile": {
    "coincidencias": [
    {
    "nombre": "JUAN PEREZ SOTO",
    "cargo": "CONCEJAL",
    "institucion": "MUNICIPALIDAD FICTICIA",
    "periodo": "2018 - 2022"
    }
    ],
    "totalCoincidencias": 1,
    "marshal": {
    "detectado": true
    }
    },
    "familiaresPep": {
    "coincidencias": [
    {
    "nombre": "FAMILIAR FICTICIO",
    "cargo": "SUBSECRETARIO",
    "institucion": "MINISTERIO FICTICIO",
    "url": "https://www.infoprobidad.cl/Declaracion/",
    "periodo": "16-01-2025",
    "datosRelaciones": [
    {
    "nombre": "JUAN PEREZ SOTO",
    "parentesco": "hijo"
    }
    ]
    }
    ],
    "totalCoincidencias": 1,
    "marshal": {
    "detectado": false
    }
    },
    "funcionariosPublicos": {
    "coincidencias": [
    {
    "nombre": "JUAN PEREZ SOTO",
    "cargo": "CONCEJAL",
    "institucion": "MUNICIPALIDAD FICTICIA",
    "periodo": "2020"
    }
    ],
    "totalCoincidencias": 1
    }
    }
    }

Campos dentro de data (persona natural):

CampoTipoPuede ser nullDescripción
rutstringNoRUT consultado (formato 12345678-9).
estadostringNo"PROCESADO" o "NO PROCESADO" (ver Sin búsqueda posible).
tipoPersonastringNoSiempre "natural".
nombrestringNoNombre completo usado en la búsqueda; "" si no hay.
riesgostringNoRiesgo agregado del perfil: "free", "medium" o "critical".
sociedadesobjectNoSociedades en las que participa la persona (ver tabla siguiente).
listasInternacionalesobjectNoCoincidencias en listas internacionales y total.
penalobjectNoCoincidencias de antecedentes penales y total.
noticiasobjectNoCoincidencias de noticias, incluidos los hallazgos de Marshal, y total.
pepChileobjectNoCoincidencias de PEP en Chile, total y detección de Marshal (ver Marshal).
familiaresPepobjectNoCoincidencias de familiares de PEP, total y detección de Marshal.
funcionariosPublicosobjectNoCoincidencias de funcionarios públicos y total.

sociedades.coincidencias[] (persona natural): un elemento por cada sociedad en la que participa la persona. totalCoincidencias es la cantidad de sociedades.

CampoTipoPuede ser nullDescripción
nombreSociedadstringSíRazón social de la sociedad en la que participa la persona.
rutSociedadstringSíRUT de esa sociedad.
nombreSociostringSíNombre de la persona consultada.
rutSociostringSíRUT de la persona consultada.
fechastringSíFecha de constitución de la sociedad (formato YYYY-MM-DD).
sociosarrayNoSocios de la sociedad (ver Estructuras comunes).
extractosarrayNoExtractos o publicaciones de la sociedad.
participacionesarraySíSociedades en las que esa sociedad participa.
fuentestringSíFuente de la relación entre la persona y la sociedad: "Diario Oficial", "Empresa en un Día", "SII", "CMF" o "MDH".

Estructuras comunes​

Estas estructuras son las mismas para personas naturales y jurídicas.

Cada bloque (sociedades, listasInternacionales, penal, noticias, pepChile, familiaresPep, funcionariosPublicos) tiene estos campos:

CampoTipoDescripción
coincidenciasarrayRegistros encontrados.
totalCoincidenciasnumberTotal de coincidencias encontradas.
marshalobjectSolo en pepChile y familiaresPep. Resultado del análisis Marshal (ver Marshal).

sociedades.coincidencias[].socios[]:

CampoTipoDescripción
nombrestringNombre del socio.
rutstringRUT del socio.
domiciliostringDomicilio del socio.
tipoDeParticipacionstringRoles unidos con " - ": Socio, Administrador, Alta dirección, Socio Indirecto.
cargostringCargo dentro de la sociedad (si aplica).
porcentajeParticipacionstringPorcentaje de participación (ej: "70").

sociedades.coincidencias[].extractos[]:

CampoTipoDescripción
actuacionstringTipo de actuación (ej: CONSTITUCION).
fechastringFecha de la actuación (formato YYYY-MM-DD).
urlstringURL al documento del extracto, si está disponible.

sociedades.coincidencias[].participaciones[]:

CampoTipoDescripción
razonSocialstringRazón social de la sociedad participada.
nombrestringMismo valor que razonSocial.
rutstringRUT de la sociedad participada.
tipoPersonastringSiempre "juridica".
tipoDeParticipacionstringRol en la sociedad participada.
cargostringCargo (si aplica).
porcentajeParticipacionstringPorcentaje de participación.
domiciliostringDomicilio declarado.
vigentebooleantrue si la participación sigue vigente.

listasInternacionales.coincidencias[]:

CampoTipoDescripción
nombrestringNombre relacionado al registro en la lista.
listastringNombre de la lista.
urlstringURL con el documento o referencia.

penal.coincidencias[]:

CampoTipoDescripción
nombrestringNombre del sujeto.
posturastringPostura en el proceso (ej: Querellante, Querellado).
rolstringRol o número de causa.
fechastringFecha de la causa (formato DD/MM/YYYY).
infraccionstringDescripción de la infracción.
estadostringEstado procesal (ej: Tramitación).
etapastringEtapa del proceso.
litigantesarrayLitigantes con nombre, sujeto y situacionLibertad.
materiastringMateria del proceso.
tribunalstringTribunal asociado.
esDenunciadobooleanIndica si el sujeto figura como denunciado.

noticias.coincidencias[]:

CampoTipoDescripción
nombrestringNombre buscado.
titulostringTítulo de la noticia o del hallazgo.
fuentestringMedio o fuente de la noticia.
urlstringURL de la noticia.
urlFuentestringURL del medio.
temaarrayTemas o categorías de riesgo asociados.
periodostringFecha de publicación (formato DD-MM-YYYY).

pepChile.coincidencias[] y funcionariosPublicos.coincidencias[]:

CampoTipoDescripción
nombrestringNombre de la persona.
cargostringCargo o posición.
institucionstringInstitución asociada.
periodostringPeriodo o fecha del cargo.

familiaresPep.coincidencias[]:

CampoTipoDescripción
nombrestringNombre del familiar PEP.
cargostringCargo o posición.
institucionstringInstitución asociada.
urlstringURL con información adicional.
periodostringPeriodo o fecha.
datosRelacionesarrayRelaciones del familiar PEP, con nombre y parentesco.

Formato de periodo: las fechas exactas se entregan como DD-MM-YYYY; los periodos que la fuente informa como año o rango (ej: "2020", "2018 - 2022") se entregan tal cual. Cuando la fuente no informa periodo, viaja null.

Nota: algunos campos pueden ser null o estar ausentes según la disponibilidad de datos en las fuentes consultadas.

Marshal​

Cuando tu plan cuenta con Marshal y el RUT está marcado con Marshal en tu cuenta (al cargarlo con includeMarshal o al usar Actualizar Marshal), el reporte incorpora el resultado del último análisis Marshal completado:

  • noticias: los hallazgos de Marshal en medios de prensa aparecen al inicio de coincidencias, con la misma estructura que una noticia, y se suman a totalCoincidencias. Su tema indica la categoría de riesgo del hallazgo.
  • pepChile.marshal.detectado: true si Marshal detectó que la persona consultada es PEP.
  • familiaresPep.marshal.detectado: true si Marshal detectó una relación con un PEP.

marshal.detectado se informa igual para personas naturales y jurídicas.

Valor de marshal.detectadoSignificado
trueMarshal detectó la condición.
falseEl análisis Marshal se completó y no detectó la condición.
nullEl RUT no tiene análisis Marshal completado (o no tiene Marshal).

Para saber si el análisis ya terminó, revisa compliance.estadoMarshal en el Resumen de un perfil. Para solicitar un análisis nuevo de un RUT ya cargado, usa Actualizar Marshal.

Sin búsqueda posible​

Si no hay un nombre o razón social con el cual buscar el RUT (o, en una persona natural, falta el apellido), el reporte viaja con estado: "NO PROCESADO" y sin coincidencias en las fuentes de compliance: listas de coincidencias vacías y totales en 0. Si el RUT tiene un análisis Marshal completado, noticias incluye igual sus hallazgos.

Glosario de Términos

Para valores como postura, estado y riesgo, consulta el Glosario de la API v2. Los términos de Marshal están en el Glosario de la API v3.

Errores​

Además de los errores comunes y los de acceso al RUT, este endpoint puede responder:

400 - RUT inválido​

El RUT de la ruta no tiene un formato válido o su dígito verificador no corresponde. Revisa el formato y vuelve a enviar la solicitud.

{
"success": false,
"code": 400,
"error": "El RUT ingresado no es válido. Por favor verifica el formato."
}

400 - corporationId no permitido​

La solicitud incluye corporationId, un parámetro que este endpoint no acepta. Quítalo y vuelve a enviar la solicitud.

{
"success": false,
"code": 400,
"error": "No se permite enviar corporationId en la petición."
}

401 - No autorizado​

El token no se envió, expiró o no es válido (ver Errores de autenticación). Si expiró, solicita uno nuevo en Obtener Token.

{
"success": false,
"code": 401,
"error": "El token de autenticación no es válido."
}

403 - RUT sin acceso​

El RUT existe en Sheriff, pero no está cargado en tu cuenta. Cárgalo con Carga de RUT antes de consultarlo.

{
"success": false,
"code": 403,
"error": "No tienes permisos para consultar este RUT."
}

403 - Plan sin el ayudante Compliance​

Tu plan no incluye el ayudante Compliance.

{
"success": false,
"code": 403,
"error": "El plan no cuenta con el ayudante de compliance."
}

404 - RUT no encontrado​

El RUT no existe en Sheriff. Cárgalo con Carga de RUT antes de consultarlo.

{
"success": false,
"code": 404,
"error": "El RUT consultado no existe en el sistema."
}

429 - Demasiadas solicitudes​

Superaste el límite de solicitudes (ver Rate Limits). Espera los segundos que indica el header Retry-After antes de reintentar.

{
"success": false,
"code": 429,
"error": "Demasiadas solicitudes desde esta API externa, intente más tarde."
}

500 - Error interno del servidor​

Ocurrió un error inesperado. Intenta nuevamente más tarde.

{
"success": false,
"code": 500,
"error": "Ocurrió un error interno. Intenta nuevamente más tarde."
}